<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>DNS Resolution</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="GnomeVFS - Filesystem Abstraction library">
<link rel="up" href="networking.html" title="Networking">
<link rel="prev" href="gnome-vfs-2.0-gnome-vfs-dns-sd.html" title="Zeroconf networking support">
<link rel="next" href="gnome-vfs-2.0-gnome-vfs-ssl.html" title="SSL support functions">
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gnome-vfs-2.0-gnome-vfs-dns-sd.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="networking.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GnomeVFS - Filesystem Abstraction library</th>
<td><a accesskey="n" href="gnome-vfs-2.0-gnome-vfs-ssl.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gnome-vfs-2.0-gnome-vfs-resolve.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gnome-vfs-2.0-gnome-vfs-resolve.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gnome-vfs-2.0-gnome-vfs-resolve"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gnome-vfs-2.0-gnome-vfs-resolve.top_of_page"></a>DNS Resolution</span></h2>
<p>DNS Resolution — Generic thread-safe address resolution functions.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gnome-vfs-2.0-gnome-vfs-resolve.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult"><span class="returnvalue">GnomeVFSResult</span></a>      <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve" title="gnome_vfs_resolve ()">gnome_vfs_resolve</a>                   (<em class="parameter"><code>const <span class="type">char</span> *hostname</code></em>,
                                                         <em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> **handle</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve-free" title="gnome_vfs_resolve_free ()">gnome_vfs_resolve_free</a>              (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>);
<span class="returnvalue">gboolean</span>            <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve-next-address" title="gnome_vfs_resolve_next_address ()">gnome_vfs_resolve_next_address</a>      (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> **address</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve-reset-to-beginning" title="gnome_vfs_resolve_reset_to_beginning ()">gnome_vfs_resolve_reset_to_beginning</a>
                                                        (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>);
                    <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress">GnomeVFSAddress</a>;
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-dup" title="gnome_vfs_address_dup ()">gnome_vfs_address_dup</a>               (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-free" title="gnome_vfs_address_free ()">gnome_vfs_address_free</a>              (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);
<span class="returnvalue">int</span>                 <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-get-family-type" title="gnome_vfs_address_get_family_type ()">gnome_vfs_address_get_family_type</a>   (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);
<span class="returnvalue">guint32</span>             <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-get-ipv4" title="gnome_vfs_address_get_ipv4 ()">gnome_vfs_address_get_ipv4</a>          (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);
<span class="returnvalue">GType</span>               <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-get-type" title="gnome_vfs_address_get_type ()">gnome_vfs_address_get_type</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-new-from-ipv4" title="gnome_vfs_address_new_from_ipv4 ()">gnome_vfs_address_new_from_ipv4</a>     (<em class="parameter"><code><span class="type">guint32</span> ipv4_address</code></em>);
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-new-from-sockaddr" title="gnome_vfs_address_new_from_sockaddr ()">gnome_vfs_address_new_from_sockaddr</a> (<em class="parameter"><code><span class="type">struct sockaddr</span> *sa</code></em>,
                                                         <em class="parameter"><code><span class="type">int</span> len</code></em>);
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-new-from-string" title="gnome_vfs_address_new_from_string ()">gnome_vfs_address_new_from_string</a>   (<em class="parameter"><code>const <span class="type">char</span> *address</code></em>);
<span class="returnvalue">char</span> *              <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-address-to-string" title="gnome_vfs_address_to_string ()">gnome_vfs_address_to_string</a>         (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gnome-vfs-2.0-gnome-vfs-resolve.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1">
<a name="gnome-vfs-2.0-gnome-vfs-resolve.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="gnome-vfs-resolve"></a><h3>gnome_vfs_resolve ()</h3>
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult"><span class="returnvalue">GnomeVFSResult</span></a>      gnome_vfs_resolve                   (<em class="parameter"><code>const <span class="type">char</span> *hostname</code></em>,
                                                         <em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> **handle</code></em>);</pre>
<p>
Tries to resolve <em class="parameter"><code>hostname</code></em>. If the operation was successful you can
get the resolved addresses in form of <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> by calling
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve-next-address" title="gnome_vfs_resolve_next_address ()"><code class="function">gnome_vfs_resolve_next_address()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
<td>hostname you want to resolve.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
<td>pointer to a pointer to a <span class="type">GnomeVFSResolveHandle</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A <a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult"><span class="type">GnomeVFSResult</span></a> indicating the success of the operation.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-resolve-free"></a><h3>gnome_vfs_resolve_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gnome_vfs_resolve_free              (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>);</pre>
<p>
Use this function to free a <span class="type">GnomeVFSResolveHandle</span> returned by
<a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve" title="gnome_vfs_resolve ()"><code class="function">gnome_vfs_resolve()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
<td>a <span class="type">GnomeVFSResolveHandle</span>.
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-resolve-next-address"></a><h3>gnome_vfs_resolve_next_address ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gnome_vfs_resolve_next_address      (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> **address</code></em>);</pre>
<p>
Stores the next <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> available in <em class="parameter"><code>handle</code></em> of the
former lookup in <em class="parameter"><code>address</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
<td>a <span class="type">GnomeVFSResolveHandle</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>a pointer to a pointer to a <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <code class="literal">TRUE</code> if the next address was stored in <em class="parameter"><code>address</code></em> or
<code class="literal">FALSE</code> if no other address is available.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-resolve-reset-to-beginning"></a><h3>gnome_vfs_resolve_reset_to_beginning ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gnome_vfs_resolve_reset_to_beginning
                                                        (<em class="parameter"><code><span class="type">GnomeVFSResolveHandle</span> *handle</code></em>);</pre>
<p>
Reset <em class="parameter"><code>handle</code></em> so that a following call to <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#gnome-vfs-resolve-next-address" title="gnome_vfs_resolve_next_address ()"><code class="function">gnome_vfs_resolve_next_address()</code></a>
will return the first resolved address.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
<td>a <span class="type">GnomeVFSResolveHandle</span>.
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="GnomeVFSAddress"></a><h3>GnomeVFSAddress</h3>
<pre class="programlisting">typedef struct _GnomeVFSAddress GnomeVFSAddress;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-dup"></a><h3>gnome_vfs_address_dup ()</h3>
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   gnome_vfs_address_dup               (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);</pre>
<p>
Duplicates <em class="parameter"><code>address</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Duplicated <em class="parameter"><code>address</code></em> or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>address</code></em> was not valid.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-free"></a><h3>gnome_vfs_address_free ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gnome_vfs_address_free              (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);</pre>
<p>
Frees the memory allocated for <em class="parameter"><code>address</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>.
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-get-family-type"></a><h3>gnome_vfs_address_get_family_type ()</h3>
<pre class="programlisting"><span class="returnvalue">int</span>                 gnome_vfs_address_get_family_type   (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);</pre>
<p>
Use this function to retrive the address family of <em class="parameter"><code>address</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A pointer to a <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The address family of <em class="parameter"><code>address</code></em>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-get-ipv4"></a><h3>gnome_vfs_address_get_ipv4 ()</h3>
<pre class="programlisting"><span class="returnvalue">guint32</span>             gnome_vfs_address_get_ipv4          (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);</pre>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The associated IPv4 address in network byte order.

Note that you should avoid using this function because newly written
code should be protocol independent.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-get-type"></a><h3>gnome_vfs_address_get_type ()</h3>
<pre class="programlisting"><span class="returnvalue">GType</span>               gnome_vfs_address_get_type          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-new-from-ipv4"></a><h3>gnome_vfs_address_new_from_ipv4 ()</h3>
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   gnome_vfs_address_new_from_ipv4     (<em class="parameter"><code><span class="type">guint32</span> ipv4_address</code></em>);</pre>
<p>
Creates a new <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> from <em class="parameter"><code>ipv4_address</code></em>.
</p>
<p>
Note that this function should be avoided because newly written
code should be protocol independent.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ipv4_address</code></em> :</span></p></td>
<td>A IPv4 Address in network byte order
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A new <span class="type">GnomeVFSAdress</span>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-new-from-sockaddr"></a><h3>gnome_vfs_address_new_from_sockaddr ()</h3>
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   gnome_vfs_address_new_from_sockaddr (<em class="parameter"><code><span class="type">struct sockaddr</span> *sa</code></em>,
                                                         <em class="parameter"><code><span class="type">int</span> len</code></em>);</pre>
<p>
Creates a new <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> from <em class="parameter"><code>sa</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>sa</code></em> :</span></p></td>
<td>A pointer to a sockaddr.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
<td>The size of <em class="parameter"><code>sa</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The new <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> 
or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>sa</code></em> was invalid or the address family isn't supported.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-new-from-string"></a><h3>gnome_vfs_address_new_from_string ()</h3>
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="returnvalue">GnomeVFSAddress</span></a> *   gnome_vfs_address_new_from_string   (<em class="parameter"><code>const <span class="type">char</span> *address</code></em>);</pre>
<p>
Creates a new <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> from the given string or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
if <em class="parameter"><code>address</code></em> isn't a valid.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A string representation of the address.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> The new <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gnome-vfs-address-to-string"></a><h3>gnome_vfs_address_to_string ()</h3>
<pre class="programlisting"><span class="returnvalue">char</span> *              gnome_vfs_address_to_string         (<em class="parameter"><code><a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a> *address</code></em>);</pre>
<p>
Translate <em class="parameter"><code>address</code></em> to a printable string.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
<td>A pointer to a <a class="link" href="gnome-vfs-2.0-gnome-vfs-resolve.html#GnomeVFSAddress" title="GnomeVFSAddress"><span class="type">GnomeVFSAddress</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A newly alloced string representation of <em class="parameter"><code>address</code></em> which
the caller must free.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15.1</div>
</body>
</html>